home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / demo / mag / DKG_ST5.lha / Bonus.LHA / Bonus / STreader.lha / streader / STread.doc < prev    next >
Encoding:
Text File  |  1997-07-15  |  10.1 KB  |  262 lines
  1.    ._______    ______    ________ ___ _____  ______   _______   _________
  2.  .-|   _   \  _\____ \  _\__    /    /    / _\____ \ |  ____/_ |  _     /_-.
  3.  |:|   \    \_     /  \_   /    \_   \    \      /  \_  \     \_  /____/ /:|
  4.  `-|_________/_________/___\_____/____\    \ ________/_________/________/--'
  5.   <------------------------------------\____\------------------------lm!-->
  6.  
  7.                 PRESENTS:
  8.  
  9.         SHOWTIME article/adverts reader 1.5 by Modem/Darkage
  10.  
  11.              * (based on the previous source by Randy/Ram Jam)
  12.  
  13.  
  14.  
  15. What is & distribution notice:
  16.  
  17. ShowTime is a diskmagazine published by Ram Jam group, with the demo scene as
  18. subject, and it has also the only CHART alive.
  19. This utility is able to display showtime articles to test them, but you have
  20. to edit articles manually with a text editor like cynus ed.
  21. In the current version it is not possible to place any cliparts within
  22. the articles, but this will be done by the coder himself, as it isnt that
  23. hard to include afterwards.
  24. Cliparts must have the max size of 320x180 in Hires and can use 15 colours.
  25. Mark the place, where the cliparts should be included. In this case, consider
  26. that the 15 text colours available will be the ones of clipart, and not the
  27. default ones!!!!
  28. The text print system is based on the original one by MASE/Ram Jam, but is
  29. recoded and enhanced. The "official" suffix for ShowTime files is ".st".
  30. STread is an utility coded especially for Ram Jam members that wants to adjust
  31. the design of articles directly, freeing much time to poor Ram Jam coders that
  32. receive only plain ascii texts to adjust.
  33. But, since many article writers like to design their own articles directly,
  34. I decided to release it also to not RamJammers, but the only use of this
  35. utility must be the design of articles for SHOWTIME.
  36. You can send articles, adverts, clip arts to:
  37.  
  38.                 Scozzari Franco
  39.                 Via Risorgimento 13/B
  40.                90040 Capaci (PA) Italy
  41.  
  42. Contact me for bug report:
  43.  
  44.     Modem/Darkage
  45.     Paolo D'Urso
  46.     Corso Garibaldi ,5
  47.     06049 Spoleto (PG)
  48.     ITALY
  49.  
  50. Or contact the original author:
  51.  
  52.     Randy/Ram Jam
  53.     Fabio Ciucci
  54.     Via S.Leonardo, 13
  55.     55100 LUCCA
  56.     ITALY
  57.  
  58. Requirements:
  59.  
  60. This utility needs a 68020+ and AGA chipset, like ShowTime, and also the
  61. reqtools.library in libs:
  62.  
  63.  
  64. How to start:
  65.  
  66. Run this utility from cli/shell, and will appear the file requester to select
  67. a showtime (.st) article. If the st format is wrong, the article will be not
  68. load, and error message(s) will be written in the shell window: look at them!
  69. If you quit, you can choose another file to load (or the same updated in
  70. multitasking with an editor), or quit definitely selecting "Cancel" in the
  71. requester.
  72.  
  73.  
  74. Instructions:
  75.  
  76. Ok, now you have read about the Viewer, but how do I write articles or
  77. adverts for Showtime ?
  78. To edit a ShowTime article you must start from a normal ascii text, without
  79. TABS (use spaces instead), and you can choose between two columns of text
  80. or fullpage, I will explain later how to do that.
  81. You can use all characters, including the special ALT+xx ones, like ²³¢¼½°©ð,
  82. except for 16x16 and 24x24 fonts, that have only normal characters.
  83. You can select the colour and the font type/size, but not load the cliparts,
  84. that is easy for me to apply manually, just reserve the space and give me the
  85. clipart (15 colours hires, max 320x180, when colour0 is "transparent").
  86. Also adverts can be tested, the routine is the same, only consider that in
  87. this part (DIARY) the background is blue and the color 02 will FLASH: to
  88. simulate this, press the MAG<->DIARY swap button in the panel.
  89. I added also the option to convert the article to ASCII only and save it.
  90. Keys: Q to Quit, -> and <- to swap pages.
  91.  
  92. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  93.  
  94. Well, the commands are:
  95.  
  96. {               -> To change font and color
  97. }               -> To end text
  98.  
  99. -The } command don't need comments.
  100. -The { command has a special syntax, which must be used to get a pleasant
  101.  result.
  102.  
  103.  {Ncc  -> N=font number, cc=colour 00-07
  104.  
  105. Examples:
  106.  
  107. {100  Font number 1, color 00
  108. {005  Font number 0, color 05
  109.  
  110. These fonts are available:
  111.  
  112. {000  Font num. 0.        8x8 normal
  113. {100  Font num. 1.        8x8 Bold (bold)
  114. {200  Font num. 2.        8x8 fine (fine)
  115. {300  Font num. 3.        16x16 fine (an 8x16 spaced)
  116. {400  Font num. 4.        16x16 full
  117. {500  Font num. 5.        8x8 fine n.2
  118. {600  Font num. 6.        24x24 normal style
  119. {700  Font num. 7.        24x24 style "cowboy"
  120. {800  Font num. 8.        24x24 style "modern"
  121.  
  122. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  123.  
  124. About colors, there are 15 available (range 00-14):
  125.  
  126. {000        Colour 00    White (use this for the main text..)
  127. {001        Colour 01    lighter blu
  128. {002        Colour 02    lighter green  (will flash in diary-adverts part)
  129. {003        Colour 03    yellow
  130. {004        Colour 04    green
  131. {005        Colour 05    blu
  132. {006        Colour 06    gray
  133. {007        Colour 07    pink
  134. {008        Colour 08   lighter white
  135. {009        Colour 09   red
  136. {010        Colour 10    orange
  137. {011        Colour 11    violet
  138. {012        Colour 12    brown
  139. {013        Colour 13    dark pink
  140. {014        Colour 14    red/blu
  141.  
  142.  
  143. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  144.  
  145. Now you know how to use fonts and colours for your text, but
  146. if you still need an example, here is one small text:
  147.  
  148.                                             <- This indicates 38 chars per
  149. -------------------------------------       line, including the "return" !
  150. {304How to paint with {303DPaint {304...
  151.  
  152. {000Ever tried to paint with {003DPaint {000?
  153. Its so easy, just start the progam
  154. and use a brush of your own....  }
  155.  
  156. --------------------------------------
  157. The text will start with a 16x16 charset and a green colour, the
  158. "DPAINT" is highlighted in yellow. Afterwards I changed to the
  159. normal charset (8x8 with colour white) and write most of the text,
  160. just highlighting the "DPaint" again (the questionmark is white
  161. again!!!). The last thing is the closing waved bracket, which indicates
  162. the end of the article.
  163.  
  164. Showtime offers you two modes for your articles/adverts, one or two
  165. columns to be used. If you write articles with 38 chars or less per
  166. line, you will get two columns, but remember that a RETURN on an
  167. editor will also be a character and used in the display, so dont wonder,
  168. if you will get a messy article, if you forget that!
  169. Each column is 38x21, you might check the "design" in order to make the
  170. article more readable and dont cut half of a schedule to another page.
  171.  
  172. The second mode works with 78 chars per line (full page), if you want this
  173. mode in your articles, you must extend the last line of each page
  174. (line 21) with more than 38 chars (if your line does not have that many
  175. chars in there, use SPACEs to make it larger !!!!!!!). You have to repeat
  176. this for every new page.... This sounds annoying, but gives us the
  177. opportunity to mix both styles in one article (for example, you might
  178. use a plain text with 38 chars per line and use a schedule with 78
  179. lines then. Afterwards you continue with the 38 mode and write the rest
  180. of the article.
  181.  
  182. Anyway, if you write an article for SHOWTIME, first write it with your
  183. editor and check, if it does fit into the restrictions and re-edit it
  184. (if it doesnt look good).
  185. The last thing you should do is adding the colours, although that will
  186. virtually scrap the design with the 38 or 78 lines it will work, as the
  187. colour-changing chars wont affect the normal text design at all !!!!
  188.  
  189. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  190. Here is an example of 38/78 columns mode:
  191.  
  192.  
  193. If you write max 38 columns  the  text
  194. will  be draw  in 2 columns, like now!
  195.  
  196.  
  197. Well,  but is also  possible to write  a max of  78 columns,  in full page: to
  198. hevitate the 2 columns routine you have to exceed  the  38th column at the end
  199. of the page, so ShowTime will understand that is not the  case to draw another
  200. column:
  201.  
  202. This is the last line, so EXCEED the 38th column to hevitate the 2nd column!
  203.  
  204.  
  205. Ok, is all for now!  But remember that
  206. spaces placed over the 38th line in  a
  207. 2 column article  can  cause BUGS!! So
  208. check every  time if  there are spaces
  209. over the 38th column!!
  210.  
  211.  
  212. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  213.  
  214. IMPORTANT: There are no ckeckings about overwriting texts, especially for
  215. 16x16 and 24x24 fonts, so BE SURE YOU ARE NOT WRITING OVER THE SCREEN BOTTOM,
  216. or probably Streader will cause a guru meditation.
  217.  
  218. NOTE: There is a bug that I was lazy to fix in time: if you read through the
  219.       text until the last page, everything seems to be fine, but if you then
  220.       switch back pages, sometime the colour of the first lines is
  221.       different to its normal state. This is because the last colour from
  222.       the previous read page is applied to the start of actual page...
  223.       To fix it place a color command {xXX in the first line of every page.
  224.       I think this is not a "bug", if you remember to redefine txt colour
  225.       every start of page, when it is required.
  226.  
  227. -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -    -   -
  228.  
  229.  
  230. History:
  231.  
  232. News from 1.0 to 1.1:   Now is possible to use all the 15 colours, instead
  233.             of only 8. The range is 00 - 14.
  234.             On the 8x8 fonts now all the ¹²³¢¼½¾·«»-å°©®þ¤µ¡ø
  235.             characters are usable, so you can use ansi logos
  236.             (especially adverts) with alt+xx characters.
  237.             NOTE: you can't use { } § , because are commands.
  238.             { and } are for text, § is used for cliparts, don't
  239.             insert any § in your texts!!!
  240.  
  241. News from 1.1 to 1.2:   Added a filerequester using reqtools.library.
  242.             So is needed reqtools.library in libs: dir...
  243.  
  244. News from 1.2 to 1.3:   Now there is a font n.5, added a st format checker
  245.             that display errors like "out of color", "out of
  246.             font", "you forgot } at the end"... added the
  247.             mag<->diary background palette swapping, added
  248.             an st->ascii converter.
  249.  
  250. News from 1.3 to 1.4:   Removed the showtime logo and background scaled to 4
  251.                         colors instead of 16, just to make the exe file
  252.                         smaller and save space. You can use the 1.3 version
  253.                         if you like the logo!
  254.  
  255. News from 1.4 to 1.5:   Fixed the background and setted again to 16 colours.
  256.                         Removed those ugly grey lines between the panels.
  257.                         Optimized the init routine. Now you can draw articles
  258.                         big also up to 50 pages! (update made by Modem/Darkage)
  259.  
  260. Signed: Fashion, Randy/Ram Jam and Modem/Darkage
  261. }
  262.